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BCC 5@@ HELP... 


CONTROL-K IS THE SYSTEM INTERRUPT CHARACTER. TYPING THIS ANYTIME WILL 
STOP COMPUTING ACTIVITY AND RETURN YOU TO YOUR CURRENT SUBSYSTEM; 

IF TYPED 2 OR 3 TIMES IN QUICK SUCCESSION, IT WILL RETURN YOU TO THE 
SYSTEM COMMAND LANGUAGE INTERPRETER. (@) 


YOU CAN STOP THIS PRINTOUT RIGHT NOW BY TYPING CONTROL-K. (IT WILL 
STOP ON ITS OWN IN ANOTHER PARAGRAPH OR SO.) 


HELP WILL SOON TYPE A “?", INDICATING THAT IT IS WAITING FOR A COMMAND. 
ONLY TWO EXIST: “D"“ FOR DESCRIBE & “F“ FOR FINISHED. FOR EXAMPLE, IF 
YOU WANT A LIST OF TOPICS WHICH HELP DISCUSSES, THE PAPER OR SCREEN 
WILL LOOK LIKE THIS: 


2?DESCRIBE TOPICS 


THE “?“ WILL HAVE BEEN TYPED BY HELP. WHEN YOU TYPE A “D"“, HELP RECOG- 
NIZES IT AND TYPES THE REST OF THE WORD (“ESCRIBE"“). THEN YOU TYPE 

THE TOPIC OF INTEREST... AND FINISH WITH A CARRIAGE RETURN. 

HELP--IN THIS CASE--WILL THEN TYPE THE TOPICS IT CAN TALK ABOUT, OR 
WILL TYPE THAT TOPIC YOU HAVE JUST ASKED FOR. | 

THE “FINISHED” COMMAND LETS YOU ESCAPE FROM HELP WHEN YOU ARE PAU. 

IT IS SUGGESTED THAT YOU DESCRIBE “HELP“ FIRST. 


GOOD LUCK. 


@HELP 
HELP IS THE SUBSYSTEM NOW RUNNING. AFTER PROVIDING THE USER WITH 
A COMPLETE LIST OF SYSTEM COMMANDS, HELP THEN DISPLAYS A “?" 
HERALD AND WAITS FOR THE USER TO GIVE THE COMMAND “DESCRIBE“ OR 
THE COMMAND “FINISHED“. “DESCRIBE”“ PRINTS OUT BRIEF INFORMATION 
ABOUT A NUMBER OF TOPICS ACCORDING TO THE LIST WHICH FOLLOWS. 
THE ENTIRE FILE OF HELP TOPICS WHICH CAN BE SEEN INDIVIDUALLY 
CAN BE PRINTED AT ONCE IF YOU WISH. IT’S 25 PAGES LONG! 
DO THE FOLLOWING: 


GET OUT OF HELP AND BACK TO THE COMMAND LANGUAGE INTERPRETER. 
MAKE YOUR TERMINAL DISPLAY APPEAR AS FOLLOWS: 


@TYPE 
FILE: #2:HELP-TEXT. 


TO GET A LIST OF AVAILABLE TOPICS, ASK HELP TO “DESCRIBE TOPICS". 
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@TOPICS 


HELP IS AVAILABLE ON THE FOLLOWING TOPICS: 


BCC 580 GENERAL INFO: 
EDITING—-CHARACTERS 
FI LE-ORGANI ZATION 
HISTORY 


SUB-PROCESS COMMANDS: 
CONTINUE 
RELEASE 


949 PROCESS COMMANDS: 
DUMP-94@ 
HELP-949@ 


FILE RELATED COMMANDS: 
COPY 
DELETE-FILES 
EXAMINE-FILE 


LINK COMMANDS: 
ALLOW-LINKS 
BREAK-LINKS 
LINK-TO 


OTHER COMMANDS: 
? 


DATE 
EMULATOR-VERSION 
HEDP 


SUBSYSTEMS: 
BASIC 
CAL 
DECTYPE 
DDT 
FTC 
FOS 
LISP 
NARP 


INTRODUCTION 
SYSTEM-—-COMMANDS 


RESET 
SAVE-CURRENT 


RECOVER-94Q 


FILE-MAINTENANCE 
LIST-FILES 
RENAME-FILE 


REFUSE-LINKS 
WHERE-IS 
WHO-IS-ON 


LINE 
LOGOUT 
SCHEDULE 


PFS 
PRINT 
QED 
OSPL 
QRUN 
RUNOFF 
SNOBOL 
TYPE 
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@INTRODUCTION 


THIS SECTION IS A GENERAL INTRODUCTION AND GUIDE TO THE NEW 
USERS OF THE BCC 5980 SYSTEM. 

THE SYSTEM IS AN EXPERIMENTAL ONE (A ONE-OF-A-KIND), A PROTOTYPE 
OF A COMMERCIAL SYSTEM THAT WAS NEVER BUILT. (DESCRIBE HISTORY FOR 
DETAILS). WHILE THE HARDWARE IS RELATIVELY OLD (1968), THE SYSTEM 
DESIGN IS QUITE NEW; ASPECTS OF IT HAVE APPEARED IN THE 379 AND IN 
THE DEC SYSTEM-2@, FOR EXAMPLE, ONLY RECENTLY. IT IS A HIGHLY 
ADVANCED SYSTEM (DISREGARDING ITS UNFINISHED, UNPOLISHED NATURE) 
UTILIZING FIVE SPECIALIZED PROCESSING UNITS EACH DEDICATED TO A 
PORTION OF THE SYSTEM’S OPERATION. THEY ARE: 


CHIO: CHARACTER INPUT/OUTPUT-- RESPONSIBLE FOR COMMUNICATION 
AND TERMINAL MANAGEMENT. 

AMC: AUXILIARY MEMORY CONTROL-- RESPONSIBLE FOR EFFICIENT 
CENTRAL MEMORY UTILIZATION AND FOR SWAPPING OF USERS 
PAGES IN A VIRTUAL STORAGE ENVIORNMENT. 

MSCH: MICRO SCHEDULER-- RESPONSIBLE fOR SCHEDULING USER’S 
REQUESTS ON THE TWO USER CPUS. 

(2)CPU: TWO USER’S CPUS. RUNS THE USER’S PROCESSES. 


THE CHIO, AMC, AND MSCH PROCESSORS COLLECTIVELY RUN THE OPERATING 
SYSTEM. ON MOST OTHER SYSTEMS THE OS IS A VERY LARGE COLLECTION OF 
SOFTWARE WHICH RUNS ON THE CPU ALONG WITH THE USERS” PROGRAMS. 

THE CODE RUN BY THESE THREE PROCESSORS IS NOT SOFTWARE; RATHER, THEY 
EACH EXECUTE THEIR PART OF THE OS DIRECTLY FROM VERY FAST MICROSTORE 
(188 NANO-SECONDS PER INSTRUCTION). THIS GIVES THE 580 IMMENSE POWER 
AT EXECUTING ITS OPERATING SYSTEM AND PERMITS IT TO DO THINGS IN WAYS 
NO OTHER SYSTEM COULD ATTEMPT WITH ORDINARY SOFTWARE. 

THE CPUS DO EXECUTE A LITTLE OPERATING SYSTEM CODE; THIS IS NECES- 
SARY IN ORDER TO ALLOW EACH USER PROCESS TO COMMUNICATE WITH THE OS. 
THE CPUS PERMIT A NUMBER OF SYSTEM CALLS, IN WHICH THE CODE READS OR 
SETS BITS IN RESIDENT SYSTEM TABLES WHICH ARE BEING SCANNED BY THE 
DEDICATED PROCESSORS. THE “SOFTWARE PORTION” OF THE OS ALSO CONTAINS 
FREQUENTLY-NEEDED UTILITY ROUTINES WHICH CAN BE RUN BY SYSTEM CALL. 

ANOTHER INTERESTING FEATURE OF THE 589 CPU IS THAT IT HAS TWO 
IDENTITIES! THAT IS, IT CAN EXECUTE THE INSTRUCTION SET AND ADDRESSING 
MODES OF TWO DIFFERENT MACHINES. ONE IS THE 5809 CPU ITSELF (A MANUAL 
WHICH CAN BE OBTAINED FROM THE EE DEPT. DESCRIBES THIS MACHINE); THE 
OTHER IS THE USER INSTRUCTION SET OF THE OLD XDS 949 COMPUTER. A BIT 
IN THE STATE WORD OF THE PROCESS DETERMINES WHICH IDENTITY THE CPU 
ASSUMES WHEN IT IS ATTACHED TO A PROCESS FOR A QUANTUM OF TIME. 

THE 949-MODE (SO-CALLED) GIVES US THE ABILITY TO RUN WITHOUT CHANGE 
ANY EXISTING 948 SOFTWARE. TO DO THIS WE HAVE AN ASSOCIATED PIECE OF 
SYSTEM SOFTWARE CALLED THE “949 EMULATOR“. THIS PROGRAM IS CALLED 
AUTOMATICALLY WHENEVER A 94@ PROGRAM ATTEMPTS A 94@ SYSTEM CALL. 

THE EMULATOR FIELDS THIS CALL, TRANSLATES IT INTO A 598 CALL, TRANS- 
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LATES THE RESULT BACK INTO THAT WHICH THE 949 WOULD GIVE UNDER THE 
CIRCUMSTANCES, AND RETURNS CONTROL TO THE 948 PROGRAM IN 94@ MODE. 
OVER HALF OF THE EXISTING SOFTWARE ON THE 5@@ TODAY IS 94@ SOFTWARE. 
BECAUSE OF ITS UNFINISHED NATURE, THE SYSTEM’S CHARACTERISTICS 
SOMETIMES CONFUSE BEGINNING USERS. AN EXAMPLE OF THIS IS THE WAY 
IN WHICH FILES ARE TREATED. IN OTHER SYSTEMS (TSO AND HP), USER 
FILES ARE KEPT TRACK OF BY THE SYSTEM IN A DIRECTORY OF SOME KIND. 
THERE IS A LOT OF COMPLEXITY IN THESE SYSTEMS ASSOCIATED WITH MAIN- 
TAINING THESE DIRECTORIES CORRECTLY, ESPECIALLY If THE SYSTEM CRASHES 
DURING A DIRECTORY UPDATE. THE 500 KEEPS TWO DIRECTORIES FOR EACH 
USER: ONE ON DISK (ALONG WITH THE LONG-TERM USER FILES) AND ANOTHER 
ON DRUM. ON LOGIN, THE DRUM DIRECTORY (THE INTERNAL SYSTEM DIRECTORY) 
WILL BE FOUND TO BE EMPTY. (IT IS EMPTIED AND ALL FILES DELETED 
WHEN THE USER LAST LOGGED OUT.) THE USER MUST THEN COPY OVER FILES 
FOUND ON DISK AND LOCATED BY HIS DISK DIRECTORY ONTO THE DRUM. 
AGAIN, UPON LOGOUT, THE USER MUST COPY BACK TO DISK ANY FILES HE WANTS 
SAVED. THIS IS ALL OUR DISK STORAGE UNIT DOES IN THE SYSTEM; 
IT IS NOT USED FOR SWAPPING USERS IN & OUT Of MEMORY OR FOR DIRECT 
FILE ACCESSES. IT IS USED EXACTLY LIKE A VERY LARGE, MAG TAPE CASSETTE 
UNIT! 
HOW IS THIS COPYING BACK AND FORTH DONE? WE USE A SUBSYSTEM -- 
A BUILT-IN PROGRAM CALLED “PFS“ (FOR PERMANENT FILE SYSTEM). 
PFS HAS A NUMBER OF COMMANDS WHICH CAN BE EXECUTED TO DO SUCH THINGS 
AS READ DISK FILES INTO THE SYSTEM, WRITE THEM BACK OUT, CONTROL 
VARIOUS KINDS OF ACCESS TO THEM, LIST OUT THE DISK FILE DIRECTORY 
ON THE TERMINAL, ETC. DESCRIBE PFS FOR DETAILS, OR SEE THE PFS MANUAL. 
WHILE THIS APPROACH MAY SEEM AT FIRST GLANCE SOMEWHAT CRUDE (IT IS), 
IT DOES HAVE SOME ADVANTAGES. FOR ONE, FILES MAY BE VERSIONED IN 
A MANNER DESIRABLE TO THE USER. MOSTLY, HOWEVER, THE ADVANTAGE IS 
THAT IT IS VIRTUALLY IMPOSSIBLE TO LOSE A FILE IN A SYSTEM CRASH. 
(THIS IS NOT TRUE OF THE HP-ACCESS OR OF TSO.) 


PAGE 5 WEDNESDAY OCTOBER 11, 1978 9:53:58 HELP-TEXT: 9SYM 


@EDITING-CHARACTERS 


THESE SPECIAL EDITING CHARACTERS ARE EFFECTIVE IN MANY SITUATIONS 
(COMMAND LANGUAGE INTERPRETER, QED, BASIC, ETC.) FOR CORRECTING 
IMMEDIATE TYPING ERRORS ON THE TERMINAL: | 


CONTROL-A: CHARACTER BACKSPACE 
CONTROL-W: PREVIOUS WORD DELETE 
CONTROL-Q: CURRENT LINE DELETE 


@HISTORY 


THE BCC 508 WAS TO BE THE PRINCIPAL RESULT OF A COMPUTER SYSTEM 
RESEARCH PROJECT AT THE UNIVERSITY OF CALIFORNIA, BERKELY IN THE ‘60S. 
THIS PROJECT, FUNDED BY THE DOD, WAS TO DEVELOP MORE EFFECTIVE MEANS 
FOR INTERACTION WITH COMPUTERS (TIME-SHARING) AND MORE EFFICIENT CEN- 
TRALIZED COMPUTER SYSTEMS. WHEN MANUFACTURERS SHOWED RELUCTANCE TO USE 
THE IDEAS Of THIS GROUP, IT LEFT THE UNIVERSITY TO FORM BERKELEY COM- 
PUTER CORPORATION (1969). IT WAS IN THIS ENVIRONMENT, WITH PRIVATE 
FUNDING, THAT THE BCC 508 WAS DESIGNED AND BUILT. 

THE 5880 WAS BUILT ONLY AS A DEMONSTRATION OF THE ACTUAL PRODUCT 
ANTICIPATED AND TO PROVE THE GROUP’S ABILITY TO BUILD BOTH A 
COMPANY (OF 15@ PEOPLE) AND A LARGE-SCALE COMPUTER. THIS WAS DONE IN 
ONLY 18 MONTHS. HOWEVER, DUE IN PART TO THE TIMES, FURTHER CAPITAL WAS 
UNAVAILABLE AND BCC WAS FORCED TO DISBAND. 

DR. LICHTENBERGER CAME TO HAWAII IN 1971 TO JOIN THE ALOHA SYS- 
TEM AND, ARMED WITH GENEROUS FUNDING FROM THE ORIGINAL DOD SOURCE, 
BROUGHT THE FORMER COMPANY'S EQUIPMENT TO THE ELECTRICAL ENGINEERING 
DEPARTMENT. HERE IT WAS SOMEWHAT REBUILT AND BEGAN TO OPERATE ONCE 
AGAIN IN MARCH, 1973. WITH THE EXCEPTION OF TWO 2-WEEK PERIODS, IT 
HAS BEEN IN OPERATION AROUND THE CLOCK, SEVEN DAYS A WEEK SINCE THEN. 

THE SYSTEM IS NOW OPERATED BY EEF FOR ITS EDUCATIONAL AND SOME 
RESEARCH NEEDS. IT IS TENUOUSLY FUNDED, BUT ITS MINIMUM OPERATIONAL 
REQUIREMENTS ARE SMALL SINCE THE EQUIPMENT IS WHOLLY OWNED BY THE 
STATE OF HAWAII. 
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@FILE-ORGANIZATION 


FILE NAMING AND COMMANDS 
A FILE DESIGNATOR CONSISTS OF A NAME AND A TYPE WRITTEN AS 
NAME: TYPE 
THE NAME MAY HAVE WORDS CONCATENATED WITH “-"“, AS IN THE NAME: 
WORD1-WORD2-WORD3 


UP TO A TOTAL OF 16 CHARACTERS. THE WORDS MAY CONTAIN LETTERS AND 
DIGITS. FILES ARE GROUPED INTO DIRECTORIES ASSOCIATED WITH USERS. 
THE FILES OF A USER LOGGED IN AT A GIVEN TERMINAL ARE DESIGNATED 
BY THEIR NAME:TYPE. FILES IN OTHER DIRECTORIES MAY BE DESIGNATED 
BY PREFIXING TO THEIR NAME:TYPE EITHER A USER NUMBER OR NAME, AS: 


#23:NAME: TYPE OR 
Q@GUEST: NAME: TYPE 


WHEN A FILE IS CREATED (FIRST REFERRED TO), THE NAME AND TYPE MUST 
BE SURROUNDED BY DOUBLE QUOTES, AS: 


*WRITE ON “NUTS: 9SYM". 


IF DOUBLE QUOTES ARE NOT REQUIRED, THE NAME MAY BE ABBREVIATED. 
ABBREVIATION ALLOWS ONE TO SUPPLY A SUBSTRING WHICH UNAMBIGUOUSLY 
SPECIFIES THE FILE. WHEN MORE THAN ONE WORD IS INVOLVED 
AND If THE ABBREVIATION OF THE FIRST WORD DOES NOT COMPLETELY 
SPECIFY IT, THEN A NEW ATTEMPT IS MADE WITH A SECOND WORD. FOR 
EXAMPLE, “LIST-FILES“ MIGHT BE ABBREVIATED AS “L-F“, “LI-FI“, OR 
MAYBE JUST “LIST“. ALL, A PORTION, OR NONE OF THESE EXAMPLES MIGHT 
SUCCEED, DEPENDING ON THE CONTENTS OF THE DIRECTORY. 
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@SYSTEM-COMMANDS 


WHEN THE COMPUTER TYPES AN “@"“ SIGN ON THE LEFT MARGIN OF YOUR 
TERMINAL, IT IS READY AND WAITING FOR A SYSTEM COMMAND TO BE TYPED 
IN. A COMMAND (A LISTING OF ALL OF THEM CAN BE OBTAINED FROM HELP) 
INSTRUCTS THE SYSTEM TO PROVIDE THE USER WITH ONE OF A NUMBER OF PRE- 
STORED SERVICES. WHEN A USER LOGS INTO THE SYSTEM, THE SESSION OR THE 
JOB STREAM CREATED BY THE USER IS CALLED A PROCESS. THUS, WHEN A 
USER TYPES IN A SYSTEM COMMAND AND INVOKES A SUBSYSTEM SUCH AS BASIC 
OR FORTRAN, THAT SUBSYSTEM RUNNING IS CALLED A SUBPROCESS. ALL 
SYSTEM COMMANDS ARE ACTUALLY FILE NAMES EXCEPT FOR SPECIAL COMMANDS. 
WHEN A COMMAND IS TYPED, WHAT HAPPENS IS THAT A SUBPROCESS OF THE 
USER'S PROCESS IS CREATED, THE SYSTEM COMMAND FILE IS ATTACHED TO 
THE SUBPROCESS (READ INTO USER’S WORKSPACE) AND THEN THE SUBPROCESS 
IS CALLED. THERE ARE 3 TYPES OF COMMANDS, PERMANENT, TEMPORARY AND 
SPECIAL. 

PERMANENT COMMANDS CAUSE THE SYSTEM TO FIRST DESTROY THE 
“CURRENT” SUB-PROCESS (IF ANY) AND SET UP, ATTACH, AND CALL 
THE NEW SUB-PROCESS. WHEN THE SUB-PROCESS TERMINATES AND RETURNS 
TO THE SYSTEM, ITS MEMORY SPACE IS RETAINED, AND IT IS CONSIDERED 
AS THE CURRENT SUB-PROCESS UNTIL THE NEXT PERMANENT COMMAND IS TYPED. 
OED AND BASIC ARE EXAMPLES OF A PERMANENT COMMAND. SINCE THE : 
MEMORY SPACE IS RETAINED AFTER A SUBPROCESS S TERMINATION, IT IS 
POSSIBLE TO RETURN TO THE EXACT STATE OF THAT SUBPROCESS BEFORE 
IT WAS TERMINATED BY USING THE “CONTINUE” COMMAND. SEE “CONTINUE “ 
DESCRIBED ELSEWHERE. 

TEMPORARY COMMANDS DO NOT AFFECT OTHER SUB-PROCESSES. RATHER, 
THEY CAUSE THE SYSTEM TO CREATE, ATTACH, AND CALL A NEW SUB-PROCESS 
WHICH IS AUTOMATICALLY DESTROYED WHEN IT IS TERMINATED. 

PFS AND WHO-IS-ON ARE SOME EXAMPLES OF THIS TYPE. 

SPECIAL COMMANDS ARE THOSE WHICH ARE NECESSARY TO MANIPULATE 
THE SUB-PROCESS STRUCTURE. THESE FOUR COMMANDS ARE THE ONLY COMMANDS 
WHICH ARE NOT FILE NAMES AND ARE BUILT INTO THE SYSTEM UTILITY. THEY 
ARE: “CONTINUE", “RELEASE“, “RESET“, AND “SAVE-CURRENT". 

@X 
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SUB-PROCESS COMMANDS 


@CONTINUE 
CAUSES THE CURRENT SUB-PROCESS (PERMANENT COMMAND) TO RESUME 
EXECUTION. FOR INSTANCE IF YOU HAD JUST EXITED BASIC AND WANTED 
TO GET BACK IN, INSTEAD OF TYPING BASIC AND HAVING TO RELOAD YOUR 
PROGRAM, ALL YOU HAVE TO DO IS TO TYPE “CONTINUE” TO GET BACK TO 
THE EXACT STATE BEFORE YOU EXITED BASIC. THIS APPLIES TO ANY OTHER 
PERMANENT COMMAND. 


@SAVE-CURRENT 
CAUSES THE CURRENT SUB-PROCESS TO BE PLACED IN A SAVE STATUS 
(IT.E. MADE NO LONGER “CURRENT“) SO THAT SUBSEQUENT PERMANENT 
COMMANDS DO NOT CAUSE IT TO BE DESTROYED. UP TO 7 SUBPROCESSES CAN 
BE SAVED PROVIDED YOU DON’T RUN OUT OF MEMORY. THIS COMMAND 
RESPONDS WITH A SUB-PROCESS NUMBER TO BE USED WITH RELATED 
COMMANDS. YOU CAN USE THIS TO TEMPORARILY SAVE DIFFERENT VERSIONS 
OF A PERMANENT COMMAND SUCH AS QED WITH DIFFERENT TEXT IN THE 
BUFFER. THIS COMMAND IS NOT TO BE CONFUSED WITH SAVING YOUR 
FILES PERMANENTLY ON DISK. SEE “PFS“ IF YOU WANT TO DO THIS. 


@CONTINUE <SUB-PROCESS> 
RESUMES EXECUTION OF THE DESIGNATED SUB-PROCESS WITHOUT DIS- 
TURBING OTHERS. THE SUB-PROCESS MAY BE DESIGNATED EITHER BY 
NUMBER OR BY THE COMMAND NAME IF IT IS UNAMBIGUOUS. FOR EXAMPLE, 
IF YOU HAD PREVIOUSLY SAVED A QED WHO’S NUMBER WAS 3, TYPE 
“CONTINUE 3“ TO GET IT BACK. 


@RELEASE <SUB-PROCESS> | 
DESTROYS THE DESIGNATED SUB-PROCESS 


@RESET 
DESTROYS ALL SUB-PROCESSES INCLUDING THE SAVED ONES. 
@X 
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948 COMMANDS 


THESE COMMANDS ARE USED ONLY IN CONJUNCTION WITH 948 PROGRAMS. 
THEY ARE: 


@DUMP-949 <FILE-NAME> 
THE 94@ PROCESS--ITS MEMORY SPACE AND ITS STATE--IS COPIED TO 
A FILE ON WHICH IT MAY BE SAVED INDEFINITELY. 


@RECOVER-94@ <FILE NAME> | 
INVERSE OF ABOVE. A PREVIOUSLY DUMPED 94@ PROCESS IS RELOADED 
AND IS MADE INTO THE CURRENT SUB-PROCESS. 


@HELP-949@ 
INITIATES A QUESTION-ANSWERING SUBSYSTEM DEALING WITH 9406 SYSTEM 
CALLS. 5 

@X 
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FILE RELATED COMMANDS: 


@FILE-MAINTENANCE 
HAS A SUB-COMMAND STRUCTURE TO DO MANY USEFUL OPERATIONS WITH 
FILES. YOU CAN ESCAPE FROM THE SUB-PROCESS WITH A “FINISH" 
COMMAND. SEE FNS/W-4 FOR DETAILS. 


Q@LIST-FILES <PARTIAL FILE NAME> <OPTION> <ORDER> 
LISTS ALL FILES DESIGNATED BY THE PARTIAL NAME IN THE 
DIRECTORY OF THE DESIGNATED USER. IF NO PARTIAL NAME IS 
GIVEN, THEN ALL FILES ARE LISTED. IF NO USER NAME IS 
DESIGNATED, LISTS THE DIRECTORY OF THE USER LOGGED IN AT THE 
GIVEN TERMINAL PLUS THE DIRECTORIES TO WHICH THE GIVEN DIR- 
ECTORY IS LINKED. 


OPTIONS: “ENTRY“ - ALL INFORMATION IN THE FILE DIRECTORY 
“BRIEF“ - TYPES ONLY THE FILE NAMES AND TYPE 
“LENGTH”“ - TYPES FILE NAME AND LENGTH OF FILE 
ORDER: “ALPHABETIC" - LISTS FILES ALPHABETICALLY 
“ENTRY " - LISTS FILES EXACTLY AS FOUND IN 


THE DIRECTORY 


@COPY-FILE <ORIGIN FILE> <DESTINATION FILE> 
OBVIOUS. SEE FNS/W-4 FOR DETAILS. 


@DELETE-FILE <PARTIAL FILE NAME> 
OBVIOUS. USERS SHOULD DELETE ANY UNNEEDED FILES FROM 
THE SYSTEM TO SAVE ON DRUM SPACE. IF THE FILE NAME IS: 


“*k:<TYPE>" - THEN ALL FILES OF THE <TYPE> ARE DELETED. 
EXAMPLE: “*:9SYM“, “*:9BIN“, “*:9DMP"., 
Ok eK - THEN ALL FILES ARE DELETED. 


@RENAME-FILE <OLD NAME> <NEW NAME> 
OBVIOUS. THE NEW NAME DOES NOT REQUIRE DOUBLE QUOTES. 


@EXAMINE-FILE <FILE NAME> 
USED TO LOOK AT FILE PARAMETERS. 
@X 
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TERMINAL LINKING COMMANDS 


A NUMBER OF COMMANDS ALLOW INSPECTION OF WHO IS ON THE SYSTEM 
AND WHERE SO THAT TERMINALS MAY BE CROSS-CONNECTED FOR COMMUNICATIONS 
PURPOSES. THEY ARE: 


@WHO-IS-ON 
TYPES A LIST OF USER NAMES CURRENTLY LOGGED INTO THE SYSTEM AND 
GIVES THEIR TERMINAL NUMBERS. TERMINAL NUMBERS CAN NORMALLY BE 
IGNORED UNLESS A GIVEN USER IS LOGGED IN AT MORE THAN ONE TERM- 
INAL. 


Q@WHERE-IS <USER> 
GIVES THE TERMINAL LINE NUMBER OF THE DESIGNATED USER, IF 
HE IS LOGGED INTO THE SYSTEM. 


@REFUSE-LINKS 
INHIBITS LINKS FROM BEING ESTABLISHED BY ANYONE TO THE TERMINAL 
FROM WHICH IT IS EXECUTED. THE SYSTEM WILL NORMALLY ALLOW | 
LINKING. 


@ALLOW-LINKS 
INVERSE OF ABOVE. 


@LINK-TO <USER> 
ESTABLISHES A LINK. EACH USER CAN SEE EACH OTHER'S ECHOES 
BUT THEIR INPUTS ARE KEPT APART. THE USER LINKED TO GETS A 
MESSAGE SO INFORMING HIM. 


IN LINKING TO A USER, IT IS POSSIBLE NOT ONLY TO SEE HIS OUTPUT 
BUT ALSO TO CONDUCT CONVERSATION WITH HIM. TO DO THE LATTER, YOU 
MUST BE AT THE COMMAND LANGUAGE LEVEL (YOU WILL BE AFTER LINKING, 
EVEN THOUGH YOU TERMINAL WILL BE TYPING WITH ANY OF THE LINKED-TO 
USER'S OUTPUT). THEN TYPE A DOUBLE-QUOTE MARK, FOLLOWED BY 
ARBITRARY TEXT. THIS PUTS YOU INTO A CONVERSATIONAL MODE IN WHICH 
SUCCESSIVE CARRIAGE RETURNS SIMPLY GIVE A NEW LINE. TO GET OUT 

OF SO-CALLED QUOTE MODE, TYPE CONTROL-K. 


@BREAK-LINKS 
CLOSES THE LINK. EITHER PARTY MAY EXECOTE IT. 
@X 
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MISCELLANEOUS COMMANDS 


A FEW OTHER COMMANDS FALL IN NO SIMPLE CATEGORY. THEY ARE: 


SAME AS TYPING HELP. FIRES UP THIS SUBSYSTEM. 


@Q@DATE 
TYPES OUT THE DATE AND TIME OF DAY. USEFUL FOR COMPUTER 
HACKERS THAT ARE ALWAYS LATE FOR APPOINTMENTS. 


@EMULATOR-VERSION 
TYPES THE VERSION OF THE 948 EMULATOR IN CURRENT USE. 


@LINE 
TYPES OUT THE LINE NUMBER TO WHICH THE PRESENT TERMINAL IS 
CONNECTED. 


@LOGOUT 
PERMITS THE USER TO LEAVE THE SYSTEM. AT THIS TIME, ALL FILES IN 
THE USERS SYSTEM DIRECTORY IS DELETED AND LOST FOREVER UNLESS 
SAVED ON THE DISK USING PFS. HE MAY LOGIN AGAIN BY TYPING 
CONTROL-K TO GET THE SYSTEM’S ATTENTION. 


@SCHEDULE 
TYPES OUT INFORMATION CONCERNING THE BCC 598 SYSTEM’S 
AVAILABILITY. 

@x 
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SUBSYSTEMS 


@BASIC , 
ACTIVATES THE BASIC LANGUAGE INTERPRETER. BASIC IS AN EASY, YET 
SOPHISTICATED LANGUAGE FOR ALL PURPOSES. PARTICULARLY STRONG 

IN MATRIX MANIPULATIONS AND FORMATTED INPUT OUTPUT, THIS 
EXTENDED BASIC FEATURES EXTENSIVE BUILT IN FUNCTIONS, FILE I/O, 
FUNCTION DEFINITIONS, CALCULATOR MODE AS WELL AS STANDARD 

BASIC. SEE THE BCC 5@@ BASIC MANUAL BY MARTHA CROSBY FOR 
DETAILS. MOST USED COMMANDS ARE: 


RUN EXECUTES YOUR PROGRAM 

QUIT EXITS BASIC AND RETURNS YOU TO EXECUTIVE 

LOAD <FILE NAME> 
LOADS .A BASIC LANGUAGE SYSTEM FILE ON THE DRUM 
INTO BASIC’S WORKSPACE 

SAVE <FILENAME> 
INVERSE OF ABOVE. WRITES A SYMBOLIC FILE FROM 
BASIC ONTO THE DRUM. PROVIDES A MEANS OF 
SAVING YOUR PROGRAM TYPED IN THE BASIC SUBSYSTEM 
BY USING PBS. 

LIST ([<STN 1> [-<STN 2>,<COMMA><STN2>...]]) 
PRINTS YOUR PROGRAM IN YOUR WORKSPACE FOR YOUR 


INSPECTION. 
EXAMPLE: 
LIST LIST ENTIRE PROGRAM 
LIST 19 LIST STATEMENT #19 
LIST 10-390 LIST STATEMENT NUMBERS 
1@ THRU 38 
LIST 19,208,390 LIST STATEMENT NUMBERS 


10, 20 AND 39 


DEL (ALL, [<STN 1> [-<STN2>,<COMMA><STN2>....]]) 
DELETES STATEMENTS IN YOUR PROGRAM 


EXAMPLE: 
DEL ALL DELETE ENTIRE PROGRAM 
DEL 10 DELETE STATEMENT #19 
DEL 19-39 DELETE STATEMENT NUMBERS 
1@ THRU 39 
DEL 10,20,39 DELETE STATEMENT NUMBERS 


19, 2@ AND 390 


IN ADDITION, BCC 5@8 SYSTEM HAS LIBRARY OF BASIC PROGRAMS 
STORED IN PFS UNDER THE DIRECTORY CALLED @BCC:. VARIOUS GAMES 
SUCH AS FOOTBALL, GOLF, AND WUMPUS AS WELL AS STATISTICAL AND 
SIMULATIONS PROGRAMS RESIDE IN THIS DIRECTORY. WITH THE EXCEP- 
TION OF FILES ENDING WITH :TCMD, ALL ARE BASIC. THE TCMD 

FILES ARE GAMES THAT ARE SYSTEM COMMANDS, STANDING FOR TEMP- 
ORARY COMMAND. TO EXECUTE THESE, SIMPLY READ THEM FROM PFS, 

AND THEN TYPE THEIR NAME (I.E. “LIMERICK") JUST LIKE A 

REGULAR SYSTEM COMMAND. A COMPLETE DESCRIPTION OF ALL 

THE PROGRAMS IN @BCC: IS WRITTEN ON THE FILE *INFO*, ALSO 


PAGE 


@CAL 


CONTROL-K 


NUMBER OF THE FORM <INTEGER>.<INTEGER>. 
IS CALLED THE PART NUMBER. ALL STEPS WITH A 
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STORED IN @BCC:. 


EXAMPLE: 

@PFS 

&READ DISK FILE @BCC:WUMPUS; 

1961 WORDS. 

&FINISHED. 

@BASIC 

BASIC-5.17 

>LOAD WUMPUS 
(WUMPUS WILL BEGIN EXECUTION) 


19-15-75 


ACTIVATES THE CAL SUBSYSTEM. SEE R-23 FOR DETAILS. CAL IS A CON- 
VERSATIONAL ALGEBRAIC LANGUAGE BASED ON THE JOSS SYSTEM. IT IS 
DESIGNED TO FACILITATE THE COMPUTER SOLUTION OF SMALL AND MEDIUM- 
SIZED NUMERICAL PROBLEMS. SINCE ITS EXECUTION IS VERY SLOW, IT IS 
NOT SUITABLE FOR PROBLEMS REQUIRING LARGE AMOUNTS OF COMPUTATION. 
IT DOES PROVIDE NEARLY FOOL-PROOF OPERATION, COMPLETE ERROR- 
CHECKING AND A VERY POWERFUL, CONVENIENT LANGUAGE. COMMANDS ARE: 


EXIT CAL & INTERRUPT COMPUTATION 
BACH STEP BEGINS WITH A STEP 


INTEGER PRECEDING THE DOT 
GIVEN PART NUMBER BELONG 


CAL PROGRAMS ARE COMPOSED OF STEPS. 
THE 
TO 


THAT PART. THE ORDERING OF THE STEPS IN THE PROGRAM IS DETERMINED BY 
STEP NUMBERS AND NOT BY THE ORDER OF INPUT. IF SEVERAL STEPS WITH THE 
SAME NUMBER ARE INPUT, THE LAST ONE WILL BE KEPT. 
INDIRECT (WITH STEP NUMBER) OR DIRECT (EXECUTE IMMMEDIATELY): 
(SET) <V> = <E> (SET MAY BE OMITTED) 
TYPE <E1l>, <E2>, «ee PRINT OUT 
TYPE IN FORM <E>: <El>, <E2>, «ee. 
TYPE (STEP) <N.N>, <N.N>, «ee 
TYPE PART <B> 
TYPE FORM <E> 
TYPE “STRING” 
TYPE ALL STEPS 
TYPE ALL FORMS 
TYPE ALL VALUES 
TYPE ALL FUNCTIONS 
TYPE ALL 


DEMAND <vVl>, 
DEMAND IN FORM <E>: 


CALL FOR TYPED INPUT 
‘NZ y Sax 


<V2>, 


eee 


<V1l>, 
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OPEN <NAME> FOR INPUT AS FILE 
OUTPUT 
CLOSE <E> 


WRITE ON <E>: <SAME OPTIONS AS 


READ FROM <E>: <V1l>, <V2>, ... 
OUTPUT ON <E>: <E1>, <E2>, ... 
INPUT FROM <E>: <Vl>, <V2> ... 


CALL <FUNCTION> ON END OF FILE 


PAGE 
LINE 


TO (STEP) <N.ND> 
TO PART <E> 
DO (STEP) <N.N> 
DO PART <kE> 


DIRECT ONLY: 
DEFINE <V>[<V>, ...] = <E> 
: -< 


WEDNESDAY OCTOBER ll, 


1978 10:04:06 HELP-TEXT: 9SYM 
<E> FILE I/O 
FOR TYPE> 


FILE OF BINARY FLOATING POINT 
NUMBERS; 2 WORDS / NUMBER 


FORMS SPACING 


EXECUTION CONTROL 


DEFINE CAL FUNCTION 


STATEMENT > 


DUMP 

TO <FILE>. 
LOAD 

FROM <FILE>. 
GO 
STEP 
CANCEL 
EDIT (OR MODIFY) <N.N>D 
EDIT FORM <E> 
EDIT <V> (FUNCTION ONLY) 


(STEP) 


DELETE 
DELETE 
DELETE 
DELETE 
DELETE 
DELETE 
DELETE 
DELETE 
DELETE 


<V> 
(STEP) <N.ND, 
PART <E> 

FORM <E> 

ALL STEPS 

ALL FORMS 

ALL VALUES 
ALL FUNCTIONS 
ALL 


<N.ND, « 


INDIRECT ONLY: 
FORM <N>: <LINE FEED> 
<STRINGO=#HFEHHES HE /SZSB 


re\\¢) 
oo 
oe 


RETURN <E> 
PAUSE 
DONE 


SAVE / RESTORE PROGRAM 


CONTINUE EXECUTION AFTER A PAUSE 
EXECUTE NEXT STEP ONLY 
CANCEL RUN 


# IS TO BE REPLACED WITH A FLOATING 
POINT NUMBER, % WITH A FIXED POINT 


VALUE OF FUNCTION RECENTLY CALLED 
STOP EXECUTION (BREAKPOINT) 
STOPS A “DO PART’ 
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SEVERAL MODIFIERS MAY BE ATTACHED TO ANY STEP: 
IF <E> 
UNLESS <E> 
WHILE <E> 
UNTIL <E> 
WHERE <V1l> = <El> & <V2> = <E2> 
FOR <V> = <E> 
<E> BY <E> TO <E> (“BY MAY BE OMITTED) 
WHILE 
UNTIL 
(AND ANY STRING OF THE ABOVE SEPARATED BY COMMAS) 


EXPRESSIONS (<E>) CONSIST OF OPERANDS & OPERATORS: 


a REPLACEMENT 

AND OR SAME AS *, + EXCEPT FOR PRECEDENCE 
NOT CHANGES 9 TO 1, ANYTHING NOT @ TO @ 
= # < <= > >= 

+ — 

* / MOD 

° EXPONENTIATION 


PRECEDENCE IS INDICATED BY THE ORDER. PARENTHESES MAY BE USED FREELY. 
If <E> THEN <E> ELSE IF <E> THEN <E> ... ELSE <E> 
“WHERE” MAY BE APPENDED TO EXPRESSIONS. 


OPERANDS: 
<VARIABLES > 
<NUMBERS> 
PI 
<SPECIAL FUNCTIONS> 
<ITERATIVE FUNCTIONS> 
<CAL FUNCTIONS > 


VARIABLES (<V>) ARE SINGLE LETTERS FOLLOWED BY 9 OR 1 DIGITS, 
WITH ANY NUMBER OF SUBSCRIPTS. E.G.: 

Xl S(1) X(¥(2Z5),W9° 2) 
NO RESTRICTIONS ON SUBSCRIPTS - TAKEN TO THE NEAREST INTEGER MOD 2°23. 


NUMBERS ARE WRITTEN WITH DECIMAL DIGITS, A DECIMAL POINT, & AN 
EXPONENT FIELD INDICATED BY “E*. E.G.: 
1@ = 1E1l = .@91E4 = IBOBODE-D3 


SPECIAL FUNCTIONS: 
SIN, COS, TAN ARG IN RADIANS 
ATAN <E,Y> RESULT IN RADIANS 
LOG, LOG19, EXP, SORT, ABS 
IP (INTEGER PART), FP (FRACTIONAL PART) 
ARGUMENT NEED NOT BE ENCLOSED IN PARENTHESES UNLESS IT HAS AN OPERATOR 
OF LOWER PRECEDENCE THAN *. ~ 
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ITERATIVE FONCTIONS: 


SUM, PROD, MAX, MIN 


CAL FUNCTIONS: 


A CAL FUNCTION IS NAMED BY A VARIABLE, WHICH CANNOT THEN HAVE NUMERIC 


VALUES. 


IT IS CALLED THUS: 
F[A, 16.3*W(3) | 


INPUT: YOU ARE EDITING THE STATEMENT LAST TYPED IN. CHARACTERS 


TYPED REPLACE OLD ONES. CONTROL CHARACTERS: 


CONTROL-A DELETE PRECEDING CHARACTER & PRINT 
W DELETE PRECEDING WORD & PRINT \ 
@) DELETE PRECEDING LINE & PRINT «7 
C COPY A CHARACTER 
S SKIP A CHARACTER & PRINT 3% 


Z<X> COPY UP THROUGH CHARACTER <X> 

X<X> COPY UP TO CHARACTER <X> 

R RETYPE UNALIGNED 

T RETYPE ALIGNED 

XY COPY REST OF OLD LINE WITHOUT TYPING; START OVER 

D COPY AND TYPE OUT REST OF OLD LINE; DONE 

Be a: COPY REST OF OLD LINE; DONE 

E (1ST TIME) SWITCH TO INSERT CHARACTERS TYPED & PRINT < 
E (2ND TIME) SWITCH BACK TO REPLACE CHARACTERS & PRINT > 
(CR) THROW AWAY THE REST OF THE OLD LINE; DONE 


@DECTYPE 


@DDT 


@FTC 


THIS PROGRAM DOES THE EXACT SAME THING AS “TYPE” BUT IS SPECIALLY 
MODIFIED TO OUTPUT CORRECTLY ON THE DECWRITER II TERMINAL. SEE 
THE HELP ON “TYPE” FOR MORE INFORMATION. 


ACTIVATES THE INTERACTIVE XDS-94%9 MACHINE LANGUAGE DEBUGGING SUB- 
SYSTEM. SEE R-ll FOR DETAILS. DDT HAS FACILITIES FOR SYMBOLIC 
REFERENCE TO AND TYPEOUT OF MEMORY CELLS AND CENTRAL REGISTERS. 
IT PERMITS THE USE OF LITERALS AS IN THE ASSEMBLER. IT CAN INSERT 
BREAKPOINTS INTO PROGRAMS, PERFORM A TRACE, AND SEARCH PROGRAMS > 
FOR SPECIFIED WORDS AND EFFECTIVE ADDRESSES. THERE IS A CONDI- 
TIONAL BREAKING FACILITY. DDT CAN LOAD BOTH ABSOLUTE AND RELOCAT-— 
ABLE FILES IN THE FORMAT PRODUCED BY THE ASSEMBLER. 


ACTIVATES THE FORTRAN COMPILER. THIS SUBSYSTEM CONTAINS ITS 
OWN HELP SERVICE. IT IS A FORM OF FORTRAN II (A LITTLE FANCIER) 
AND IS DESCRIBED IN A FORTHCOMING MANUAL. THE COMPILER IS 
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ACCOMPANIED BY AN OPERATING SYSTEM (FOS) WHICH PERFORMS LOADING 


AND EXECUTION CONTROL. 


THIS SUBSYSTEM 


ONLY RECENTLY BECOME AVAILABLE. 
IS OVER TEN YEARS OLD & THOROUGHLY 


@FOS 
ACTIVATES THE FORTRAN II OPERATING SYSTEM, 
CONTAINS ITS OWN HELP SERVICE. 
@LISP 
A LISP MANUAL FOR THE 5989 HAS 
(DON T WORRY...THE LISP ITSELF 
DE-BUGGED.) WE HAVEN ’T YET HAD TIME TO UPDATE THE HELP TEXT 
ON THIS SUBJECT. 
@NARP 


ACTIVATES NARP. 


BLY AND MACRO FACILITIES. THE 


SEE R-32 FOR DETAILS. 
BLER FOR THE XDS 949 WITH LITERAL, 


NARP IS A ONE-PASS ASSEM- 
SUBPROGRAM, CONDITIONAL ASSEM- 
SOURCE LANGUAGE FOR NARP, PRIMARILY 


A ONE-FOR-ONE REPRESENTATION OF MACHINE LANGUAGE WRITTEN IN SYM- 


BOLIC FORM, IS VERY SIMILAR TO 
NOTABLE EXCEPTIONS, 


THAT FOR ARPAS, BUT THERE ARE 


MAKING IT NECESSARY TO DO A CERTAIN AMOUNT OF 


TRANSLITERATION TO CONVERT AN ARPAS PROGRAM TO NARP PROGRAM. 


MNEMONIC FOR INSTRUCTIONS: 
COPY <SYMBOL>, MNEMON 


«ee 


DATA GENERATION: 
DATA <EXPRESSIOND, 
ASC <STRING> 
TEXT <STRING> 


VALUE DECLARATION: 


<SYMBOL> EQU <EXPRESSION> EQUATE 
<SYMBOL> EXT (<EXPRESSION>) DEFINE 
<SYMBOL> NARG NUMBER 


<SYMBOL> NCHR (<CHARACTER STRING>) 
NUMBER 

<SYMBOL> OPD <VALUE>(,<CLASS>(,<SHIFT 
DEFINE 


IC FOR RCH 


GENERATE DATA 
GENERATE TEXT 
GENERATE TEXT (4 CHARACTERS/WORD) 


(3 CHARACTERS /WORD) 


A SYMBOL TO A VALUE 
A SYMBOL AS EXTERNAL 
OF ARGUMENTS 


OF CHARACTERS 
KLUDGE>) ) 
AN OPCODE 


<SYMBOL> POPD <VALUE>(,<CLASS>(,<SHIFT KLUDGE>) ) 


DEFINE 


ASSEMBLER CONTROL: 
BES <EXPRESSION> 
BSS <EXPRESSION> 
END 
DEC 
OCT | 
FRGT <SYMBOL>, 
<SYMBOL> IDENT 
DELSYM 


END OF 


DO NOT 


«ee @ 


DO NOT 


A PROGRAMMED OPERATOR 


BLOCK ENDING SYMBOL 
BLOCK STARTING SYMBOL 


ASSEMBLY 


INTERPRET INTEGERS AS DECIMAL 
INTERPRET INTEGERS AS OCTAL 


OUTPUT A SPECIFIC SYMBOL 


IDENTIFICATION OF A PACKAGE 


OUTPUT ANY SYMBOLS 
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RELORG <EXPRESSION> ASSEMBLE RELATIVE WITH ABSOLUTE ORIGIN 

RETREL RETURN TO RELOCATABLE ASSEMBLY 

PREEZE PRESERVE SYMBOLS, OPCODES, AND MACROS 
OUTPUT AND LISTING CONTROL: 

LIST (<SYMBOL>, ...«) SET LISTING CONTROLS 

NOLIST (<SYMBOL>, ...«) RESET LISTING CONTROLS 

PAGE (<EXPRESSION>) BEGIN A NEW PAGE ON THE LISTING 

REM <TEXT> TYPE OUT REMARK 
CONDITIONAL ASSEMBLY AND MACROS: 

IF <EXPRESSION> BEGIN IF BODY 

ELSF <EXPRESSION> ALTERNATIVE IF BODY 

ELSE ALTERNATIVE If BODY 

ENDF END IF BODY 


RPT <EXPRESSION>(,<INCREMENT LIST>) 

BEGIN REPEAT BODY 
CRPT <EXPRESSION>(,<INCREMENT LIST>) 

BEGIN CONDITIONAL REPEAT BODY 

ENDR END REPEAT BODY 
<NAME> MACRO (<DUMMY>(,<GENERATED>,<EXPRESSION>) ) 

BEGIN MACRO BODY 
LMACRO (SAME AS MACRO) ALTERNATIVE TO MACRO 
ENDM END MACRO BODY 
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@PFS 
INITIATES THE PERMANENT FILE SUBSYSTEM WHICH ALLOWS THE USER 
TO STORE AND RETRIEVE FILES ON DISK OUTSIDE THE CONTROL OF THE 
OPERATING SYSTEM, USING THE DISK AS A CLASSICAL I/O DEVICE. 
THROUGH THIS SYSTEM THE USER CAN PROTECT HIS FILES FROM A SYSTEM 
MALFUNCTION. RETRIEVE “@SOFTWARE: PFS-MANUAL”’ FROM PFS FOR 
DETAILS BY FIRST BEING IN EXECUTIVE: 
@PFS 
&READ DISK FILE @SOFTWARE: PFS-MANUAL; 
11842 WORDS. 
&FINISHED. 
Q@TYPE (WE MUST USE TYPE SUBSYSTEM TO SEE THE TEXT) 
FILE: PFS-MANUAL 
THE MOST FREQUENTLY USED COMMANDS ARE: 
&READ DISK FILE <NAME>; COPY FILE FROM DISK INTO SYSTEM 
&WRITE DISK FILE <NAMED; COPY FILE FROM SYSTEM ONTO DISK 
&LIST. LIST PFS DIRECTORY FOR USER 
&CHANGE FILE NAME <OLD-NAME>. OBVIOUS 
TO <NEW NAME>. 
&DELETE FILE <FILE-NAME>. OBVIOUS 
&PINISH. EXIT SUBSYSTEM 
@PRINT <FILE-NAME>,<SPACING>, <LINE-NUMBERING> 


PRINTS SYMBOLIC FILES ON THE IOMEC LINE PRINTER LOCATED 
IN HOLMES 486. OPTIONS ARE: 


<SPACING> ) SINGLE (DEFAULT) 
D DOUBLE 
A NO PAGE BREAKS 
<LINE-NOUMBERING> N NO (DEFAULT) 
Y YES, NUMBER THE LINES 
OMIT ALL OPERANDS ENTER PRINT SUB-SYSTEM. PRINT HAS A SUB-COMMAND 


STRUCTURE TO CONTROL THE QUEUE OF SYMBOLIC FILES 
FOR THE LINE PRINTER. YOU CAN ESCAPE FROM PRINT 
WITH A “FINISH” COMMAND. TYPE “HELP“ ONCE YOU'RE 
IN THE PRINT SUBSYSTEM FOR DETAILS. | 
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@QED ; 
ACTIVATES THE SYMBOLIC TEXT EDITING SUBSYSTEM. SEE R-15 FOR DE- 
TAILS. QED HAS FACILITIES FOR INSERTING, DELETING AND CHANGING 
LINES OF TEXT STORED WITHIN IT. THE TEXT MAY HAVE BEEN TYPED INTO 
QED OR IT MAY HAVE BEEN COPIED IN FROM AN EXISTING SYMBOLIC FILE. 
BEFORE QED IS TERMINATED, IT MUST BE TOLD TO ‘WRITE’ ITS TEXT OUT 
ON SOME FILE. IF THAT FILE IS THE SAME ONE USED INITIALLY TO LOAD 
QED, THEN THE FILE WILL BE CHANGED. IT IS IMPORTANT TO UNDERSTAND 
THAT QED WORKS ON A COPY OF A FILE RATHER THAN ON THE FILE 
ITSELF. QED CONTAINS A LINE EDIT FEATURE, A SYMBOLIC SEARCH FEA- 
TURE, AUTOMATIC TABS WHICH MAY BE SET BY THE USER AND 36 STRING 
BUFFERS. A SUBSTITUTE COMMAND PERMITS ALL OCCURENCES OF A SPECI- 
FIED STRING OF CHARACTERS TO BE REPLACED WITH ANOTHER. 

GENERAL RULES FOR USE ARE: 


CONTROL-K IS THE ESCAPE CHARACTER. 
FIRST COMMAND MUST BE A “READ” OR AN ‘APPEND’ TO LOAD QED’S TEXT COPY. 
WHEN TEXT HAS BEEN ENTERED INTO QED, THE FOLLOWING COMMANDS MAY BE USED: 


INPUT/OUTPUT COMMANDS, <ADDR> DEFAULTS TO LINE IN PARENTHESES 
(SEE BELOW FOR <ADDR> OPTIONS): 
*<ADDR>READ FROM <FILE>. READ FILE & PLACE IN QED’S TEXT COPY 
BELOW (EXISTING TEXT) ADDRESS 
*<ADDRI>,<ADDR2>WRITE ON <FILE>. WRITE (ENTIRE) LINE(S) OF TEXT ON FILE 


* <ADDR>APPEND. PLACE FOLLOWING TERMINAL INPUT BELOW 
(EXISTING TEXT) ADDRESS 

*<ADDR>OINSERT. INSERT FOLLOWING TERMINAL INPUT BEFORE 
(CURRENT) LINE (S) 

* <ADDR1>,<ADDR2>CHANGE. REPLACE (CURRENT) LINE(S) WITH THE 


FOLLOWING TERMINAL INPUT TEXT 
FOLLOWING COMMANDS ARE VALID DURING APPEND, INSERT, & CHANGE: 


CONTROL-D STOP QED FROM PLACING TERMINAL INPUT 
INTO TEXT (STOP APPEND, INSERT, & CHANGE) 
CONTROL-A (TYPES 7) BACKSPACE ONE CHARACTER 
CONTROL-W (TYPES \) BACKSPACE ONE WORD 
CONTROL-Q (TYPES -) BACKSPACE ONE LINE 
(CR) START NEW LINE 
* <ADDR1>,<ADDR2>DELETE. DELETE (CURRENT) LINE(S) 
* <ADDR1>,<ADDR2>PRINT. PRINT (CURRENT) LINE(S), PAGE FORMATTED 
* <ADDR>,<ADDR>/ PRINT (CURRENT) LINE(S) 
* (LF) PRINT NEXT LINE 
«” PRINT PREVIOUS LINE 
*PINISHED. FINISH & EXIT QED SUBSYSTEM 
TEXT LINE ADDRESSING - <ADDR>: | | 
<NUMBER> FIRST LINE OF TEXT IS NUMBERED 1 
: CURRENT LINE OF TEXT 
S LAST LINE OF TEXT 
@ ENTIRE COPY OF TEXT = 1,$ 
[<TEXT>] | ARBITRARY TEXT (SEQUENCE OF CHARACTERS) 
: <LABEL>: LABEL (FIRST TEXT OF LINE, FOLLOWED BY 


, CHARACTER OTHER THAN LETTER OR DIGIT) 
<ADDR> IS ANY LEGAL ADDRESS FROM THE ABOVE ADDRESSING COMMANDS ; 
<ADDR1>,<ADDR2> ADDR1 THROUGH ADDR2 
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<ADDR1>+/-<ADDR2> 


COMMANDS TO MODIFY LINES, 


*<ADDR1>,<ADDR2>EDIT. 
* <ADDR1>,<ADDR2>MODIFY. 


COPY 


CONTROL CHARACTERS FOR 
OF THE LINE BEING EDITED 


BACKSPACE ONE CHARACTER 


ONE WORD 

ONE LINE 

ONE CHARACTER, 
RESTORATIVE 


TERMINATE LINE OF EDIT/MODIFY 


COPY 


SKIP 


MODE 


UP TO CHARACTER <X> 

THROUGH CHARACTER <X> 

REST OF LINE & TERMINATE 

REST OF LINE (NOT TYPED) 
& TERMINATE 

ONE CHARACTER 

TO TAB STOP 

TO END OF LINE 

ONE CHARACTER 

UP TO CHARACTER <X> 

THROUGH CHARACTER <X> 

CHANGE - INSERT/REPLACE 

(NORMAL MODE IS REPLACE) 


CONCATENATE-RE-EDIT 


TAKE 


CHARACTER <X> LITERALLY 


RETYPE ALIGNED 
RETYPE UNALIGNED 
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START AT <ADDRI> & SEARCH FOR NEXT (+) 
OR PREVIOUS (-) <ADDR2>; SPACE MAY BE 
TYPED IN PLACE OF ‘+’; 
AROUND 


<ADDR> DEFAULTS TO () 
PRINT & ALLOW EDIT OF 
EDIT (CURRENT) LINE (S) 


(CURRENT) LINE (S) 


TEXT “EDIT” & “MODIFY” QED KEEPS A 
UNTIL THE EDIT IS TERMINATED. 
CONTROL-A (TYPES ~) 

CONTROL-W (TYPES \) 

CONTROL-Q (TYPES -) 

CONTROL-N (TYPES 7) 


(CR) / CONTROL-M 


CONTROL-O <X> 

CONTROL-=Z <X> 

CONTROL-D 

CONTROL-F 

CONTROL-C 

CONTROL-U 

CONTROL-H 

CONTROL-S 

CONTROL-P <X> 

CONTROL-X <X> 

CONTROL-E (TYPES °“<° FOR INSERT, 

“>” FOR REPLACE) 

CONTROL-Y 

CONTROL-V <X> 

CONTROL-T 

~CONTROL-R 


* <ADDR> , <ADDR>SUBSTITUTE (<OPTIONS>) /<NEW-TEXT> /FOR/<OLD-TEXT> / 


SUBSTITUTE OPTIONS: 
DEFAULT 
-L 
:W 


2V 
: <NUMBER> 
2G 


2W & 


OTHER USEFUL COMMANDS: 


* <ADDR>= 
*<ADDR>-A 
*TABS. 


CONTROL-I 


SUBSTITUTES <NEW-TEXT> FOR <OLD-TEXT> IN 


(CURRENT) LINE (S) 


MAKE ALL SUBSTITUTIONS 

PRINT LINE AFTER SUBSTITUTIONS 
PRINT: LINE BEFORE SUBST., 
OPTION CAUSES OPTION CHANGE, 
CAUSES NO SUBST., 
:L COMBINED 
MAXIMUM NUMBER OF SUBSTITUTIONS 
NOT PRINT AFTER SUBSTITUTION 


“S° CAUSES SUBST., NEW 
ANY OTHER CHARACTER 


& THEN CONTINUE 


TO MAKE 


GIVE LINE NUMBER 

GIVE SYMBOLIC ADDRESS 

FOLLOWING INPUT IS <13 DECIMAL NUMBERS 
FOR TAB POSITIONS 

TAB 


SEARCH WILL WRAP- 
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QED HAS 36 BUFFERS, NAMED 6-9 & A-Z, FOR HOLDING USER’S STRINGS 
OF CHARACTERS. QED USES @ & 1 FOR SEARCHES, SUBSTITUTES, & CONTROL-L. 
BUFFER CONTROL COMMANDS: 
*<ADDRI1>,<ADDR2>LOAD #<BUFFER>. LOAD BUFFER WITH (CURRENT) LINE(S) 
*<ADDR1>,<ADDR2>GET #<BUFFER>. LOAD BUFFER WITH (CURRENT) LINE(S) & 
DELETE FROM TEXT 


*JAM INTO #<BUFFER>. LOAD FOLLOWING TERMINAL INPUT INTO BUFFER 
[CONTROL-D TERMINATES] 
*BUFFER #<BUFFER>. PRINT CONTENTS OF BUFFER 
*KILL #<BUFFER>. CLEAR BUFFER 
SPECIAL BUFFER COMMANDS: 
CONTROL-B <BUFFER> INSERT BUFFER TEXT INTO QED TEXT 
CONTROL-L LOAD BUFFER 1 WITH COPY OF TEXT IMMED- 


IATELY FOLLOWING UNTIL ANOTHER CONTROL-L 


@QRUN 
ACTIVATES THE QSPL SUBSYSTEM WHICH RUNS QSPL PROGRAMS. SEE R-28 
FOR DETAILS. THE QSPL LANGUAGE IS INTENDED TO BE A SUITABLE 
VEHICLE FOR PROGRAMS WHICH WOULD OTHERWISE BE WRITTEN IN xXDS-949@ 
MACHINE LANGUAGE FOR REASONS OF EFFICIENCY OR FLEXIBILITY. IT IS 
PART OF A SYSTEM WHICH INCLUDES A COMPILER CALLED QSPL AND THIS 
RUNTIME WHICH IMPLEMENTS THE INPUT-OUTPUT AND STRING-HANDLING 
FEATURES OF THE LANGUAGE AS WELL AS A FAIRLY ELABORATE STORAGE 
ALLOCATOR. 


CONTROL-K IS THE ESCAPE CHARACTER. 


ORUN IS ACTUALLY A MODIFIED VERSION OF THE 9498 DDT; IT HAS ADDED 
KNOWLEDGE ABOUT CERTAIN QSPL CONSTRUCTS SUCH AS THE “CALL“ POPCODE 
DEFINITION, AND SEVERAL RUNTIME SYMBOL LOCATIONS. (QRUN SETS SEVERAL 
POP DEFINITIONS FOR THE USER.) IN ADDITION, IT CONTAINS (PRE-LOADED AT 
34900B) THE CODE WHICH IMPLEMENTS THE QSPL RUNTIME. QRUN SHOULD BE USED 
FOR DEBUGGING OF QSPL PROGRAMS WHICH USE THE RUNTIME FEATURES, OTHERWISE 
949 DDT WILL BE ADEQUATE (THE ONLY POP WHICH WILL BE REQUIRED IS 
FOR “CALL" WHICH CAN BE IMPLEMENTED BY A “BRU* 9“ AT LOCATION 160B). 
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ACTIVATES THE QSPL SUBSYSTEM WHICH COMPILES QSPL PROGRAMS. SEE 
R-28 FOR DETAILS. THE QSPL LANGUAGE IS INTENDED TO BE A SUITABLE 
VEHICLE FOR PROGRAMS WHICH WOULD OTHERWISE BE WRITTEN IN XDS-94@ 
MACHINE LANGUAGE FOR REASONS OF EFFICIENCY OR FLEXIBILITY. IT IS 
PART OF A SYSTEM WHICH INCLUDES THIS COMPILER CAPABLE OF PRODUC- 
ING REASONABLY EFFICIENT OBJECT CODE AND A RUNTIME CALLED QRUN. 


CONTROL-K IS THE ESCAPE CHARACTER. 


12/18/6 
SOURCE 


A PROGRAM IS COMPILED WITH THE FOLLOWING ACTIONS: 


9 DATE OF LAST QSPL ASSEMBLY 

FILE: <FILE-NAME> <TERMINATING-CHARACTER> 
<TERMINATING-CHARACTER> IS EITHER “.“ 
- ASSUME DEFAULT FILE FOR BINARY AND 


LISTING, OR “,“ OR “;“ -— DEMAND FURTHER 
FILE NAMES 
BINARY FILE: <FILE-NAME> <TERMINATING-CHARACTER> DEFAULT IS “NOTHING“ 
LISTING FILE: <FILE-NAME>. DEFAULT IS “NOTHING" 
THE LISTING FILE CAN BE USED AS INPUT TO THE NARP ASSEMBLER AND 
IS THUS AVAILABLE FOR MODIFICATION BY THE USER. 
@RUNOFF 


INITIATES A TEXT PROCESSING SYSTEM WHICH PERMITS NEATLY FOR- 
MATTED DOCUMENTS TO BE PRODUCED BY COMPUTER. IT FEATURES 


AUTOMATIC PAGE NUMBERING, HYPHENATION, RIGHT MARGIN JUSTIFI- 


CATION, UNDERLINING, CENTERING UPON SPECIFIC COMMANDS. A MUST 
FOR STUDENTS OR FACULTY WHO MUST WRITE A TERMPAPER, THESIS OR 
EVEN A BOOK. FOR DETAILS SEE THE RUNOFF MANUAL STORED IN PFS 
UNDER @SOFTWARE:. (17 PAGES!) IT MAY BE RETRIEVED AS FOLLOWS: 


@PFS | 

&READ DISK FILE @SOFTWARE: RUNOFF-MANUAL; 
1262@ WORDS. 

&FPINISHED. 

Q@TYPE 

FILE: RUNOFF-MANUAL 
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@SNOBOL 
ACTIVATES THE XDS-948 SNOBOL4 SYBSYSTEM. SEE R-34 FOR DETAILS. 
THE XDS-94@ SNOBOL4 SYSTEM WILL ACCEPT PROGRAMS WRITTEN IN A 
LANGUAGE WHICH IS COMPATIBLE WITH A SUBSET OF BELL LABS” NOV., 
1967, VERSION OF SNOBOL4. SNOBOL4 PERMITS PROGRAMS TO BE CREATED, 
RUN AND DEBUGGED INTERACTIVELY. THE DATA OBJECT IS A STRING OF 
CHARACATERS. THE LANGUAGE PERMITS BUILDING UP LONGER STRINGS FROM 
SHORTER STRINGS THROUGH CONCATENATIONS. THROUGH PATTERN MATCHING, 
STRINGS CAN HAVE THEIR CONTENTS TESTED AND HAVE THE MATCHED SUB- 
STRINGS ASSIGNED TO STRING VARIABLES. OTHER FEATURES ARE ARITH- 
METIC ON INTEGER STRINGS, BUILT-IN FUNCTIONS, AND PROGRAMMER DE- 
FINED FUNCTIONS WHICH MAY HAVE LOCAL VARIABLES AND CAN BE RECUR- 
SIVE TO ARBITRARY DEPTH. I/O FROM FILES AND TELETYPE IS PROVIDED. 


THE SNOBOL SYSTEM IS DIVIDED INTO 2 PARTS: EDITOR-COMPILER AND 
RUNTIME. EDITOR-COMPILER IS USED TO WRITE, MODIFY, AND COMPILE SOURCE 
STATEMENTS. RUNTIME IS RESPONSIBLE FOR EXECUTION OF STATEMENTS. 


EDITOR-COMPILER COMMANDS: 
AS EACH SOURCE STATEMENT IS READ OR TYPED, IT IS COMPILED. EDITING IS 
DONE IMMEDIATELY. EDITOR COMMANDS AND ADDRESSING ARE LIKE QED. 


RUNTIME COMMANDS: 


S<ADDR>GO. BEGIN EXECUTION OF PROGRAM AT (DEFAULT - 
FIRST LINE) ADDRESS (CONFIRM WITH °.°) 

S<ADDR1>,<ADDR2>BREAK. SET BREAKPOINTS ON ALL STATEMENTS IN THE 

| INTERVAL ADDRESSED 

S$<ADDR1>,<ADDR2>KILL. RELEASE ALL BREAKPOINTS IN THE INTERVAL 
ADDRESSED 

S$<ADDR1>,<ADDR2>LIST. PRINT ALL BREAKPOINTS THE INTERVAL 
ADDRESSED 

SPROCEED. CONTINUE EXECUTION AFTER BREAKPOINT 

CONTROL-K (ONCE) DURING EXECUTION CAUSE A BREAK AT THE 


START OF THE NEXT STATEMENT; AT OTHER 
TIMES, EXIT SUBSYSTEM 

CONTROL-K (TWICE) DURING EXECUTION, RETURN IMMEDIATELY 
TO EDITOR 

S (SPACE) <UNLABELED-STATEMENT>. EXECUTE SNOBOL STATMENT IMMEDIATELY 


APPLICABLE QED COMMANDS (SEE QED FOR MORE INFORMATION) : 
/ 


APPEND / INSERT 

CHANGE / DELETE 

EDIT / MODIFY 

READ FROM / WRITE ON 

FINISHED 

SUBSTITUTE 

TABS AND (CR) 

EVERY INPUT OF A LINE CAN BE TREATED AS AN EDIT OF THE PREVIOUS LINE 
TYPED OR DELETED. THUS, THE EDIT COMMANDS CAN BE USED TO COPY AND 
MODIFY THE PREVIOUS LINE TO CREATE THE NEW LINE. CONTROL-D IS A 
TERMINATOR FOR INPUT ONLY WHEN NO CHARACTERS ARE IN THE INPUT LINE. 
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@TYPE 
PROVIDES A FACILITY FOR TYPING SYMBOLIC FILES AT THE TERMINAL, 
AS OPPOSED TO PRINTING THEM ON THE LINE PRINTER. QED PROVIDES 
A SIMILAR FACILITY, EXCEPT THAT A RUNOFF-PRODUCED FILE CANNOT 
BE HANDLED BY QED BECAUSE QED DOES NOT RECOGNIZE LOWER CASE 
LETTERS. TYPE EXISTS FOR THIS PURPOSE; AND IF THE TERMINAL IS 
CAPABLE OF UPPER/LOWER CASE, THEN BOTH CASES WILL BE HANDLED. 
OTHERWISE THE TEXT WILL COME OUT IN UPPER CASE ONLY. TYPE 
EXPECTS A FILE NAME, BUT IT ASKS FOR THE NAME EXPLICITLY, RATHER 
THAN TAKING THE NAME AS A COMMAND ARGUMENT. 


